---
layout: docs
page_title: 'nomad eval list command reference'
description: |
  The `nomad eval list` command displays a list of all evaluations or evaluations that match a filter.
---

# `nomad eval list` command reference

The `eval list` command is used list all evaluations.

## Usage

```plaintext
nomad eval list [options]
```

The `eval list` command requires no arguments.

When ACLs are enabled, this command requires a token with the `read-job`
capability for the requested namespace.

## Options

- `-verbose`: Show full information.
- `-per-page`: How many results to show per page.
- `-page-token`: Where to start pagination.
- `-filter`: Specifies an expression used to filter query results.
- `-job`: Only show evaluations for this job ID.
- `-status`: Only show evaluations with this status.
- `-json`: Output the evaluation in its JSON format.
- `-t`: Format and display evaluation using a Go template.
- `-ui`: Open the evaluations page in the browser.

## Examples

List all tracked evaluations:

```shell-session
$ nomad eval list -per-page 3 -status complete
ID        Priority  Triggered By        Job ID   Namespace  Node ID  Status    Placement Failures
456e37aa  50        deployment-watcher  example  default    <none>   complete  false
1a1eafe6  50        alloc-stop          example  default    <node>   complete  false
3411e37b  50        job-register        example  default    <node>   complete  false

Results have been paginated. To get the next page run:

nomad eval list -page-token 9ecffbba-73be-d909-5d7e-ac2694c10e0c
```

## General options

@include 'general_options.mdx'
